home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xt / XtNameToWidget.z / XtNameToWidget
Text File  |  1998-10-30  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtNameToWidget, XtWindowToWidget - translating strings to
  10.           widgets or widgets to windows
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Widget XtNameToWidget(_r_e_f_e_r_e_n_c_e, _n_a_m_e_s);
  14.                 Widget _r_e_f_e_r_e_n_c_e;
  15.                 String _n_a_m_e_s;
  16.  
  17.           Widget XtWindowToWidget(_d_i_s_p_l_a_y, _w_i_n_d_o_w)
  18.                 Display *_d_i_s_p_l_a_y;
  19.                 Window _w_i_n_d_o_w;
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           _d_i_s_p_l_a_y   Specifies the display on which the window is
  23.                     defined.
  24.  
  25.           _n_a_m_e_s     Specifies the fully qualified name of the desired
  26.                     widget.
  27.  
  28.           _r_e_f_e_r_e_n_c_e Specifies the widget from which the search is to
  29.                     start.
  30.  
  31.           _w_i_n_d_o_w    Specify the window for which you want the widget.
  32.  
  33.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.           The _X_t_N_a_m_e_T_o_W_i_d_g_e_t function looks for a widget whose name is
  35.           the first component in the specified names and that is a
  36.           pop-up child of reference (or a normal child if reference is
  37.           a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s).  It then uses that
  38.           widget as the new reference and repeats the search after
  39.           deleting the first component from the specified names.  If
  40.           it cannot find the specified widget, _X_t_N_a_m_e_T_o_W_i_d_g_e_t returns
  41.           NULL.
  42.  
  43.           Note that the names argument contains the name of a widget
  44.           with respect to the specified reference widget and can
  45.           contain more than one widget name (separated by periods) for
  46.           widgets that are not direct children of the specified
  47.           reference widget.
  48.  
  49.           If more than one child of the reference widget matches the
  50.           name, _X_t_N_a_m_e_T_o_W_i_d_g_e_t can return any of the children.  The
  51.           Intrinsics do not require that all children of a widget have
  52.           unique names.  If the specified names contain more than one
  53.           component and if more than one child matches the first
  54.           component, _X_t_N_a_m_e_T_o_W_i_d_g_e_t can return NULL if the single
  55.           branch that it follows does not contain the named widget.
  56.           That is, _X_t_N_a_m_e_T_o_W_i_d_g_e_t does not back up and follow other
  57.           matching branches of the widget tree.
  58.  
  59.           The _X_t_W_i_n_d_o_w_T_o_W_i_d_g_e_t function translates the specified
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           window and display pointer into the appropriate widget
  75.           instance.
  76.  
  77.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  79.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.